﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>WinGetList - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The WinGetList function returns an array of unique ID numbers (HWNDs) for all existing windows that match the specified criteria." />
<meta name="ahk:equiv-v1" content="lib/WinGet.htm#List" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
</head>
<body>

<h1>WinGetList</h1>
<p>返回符合指定条件的所有现有窗口的唯一 ID 号(HWND) 数组.</p>

<pre class="Syntax">HWNDs := <span class="func">WinGetList</span>(<span class="optional">WinTitle, WinText, ExcludeTitle, ExcludeText</span>)</pre>

<h2 id="Parameters">参数</h2>
<dl>
    <dt>WinTitle, WinText, ExcludeTitle, ExcludeText</dt>
    <dd>
        <p>类型: <a href="../Concepts.htm#strings">字符串</a>, <a href="../Concepts.htm#numbers">整数</a>或<a href="../Concepts.htm#objects">对象</a></p>
        <p>如果这些都是空白或省略, 则将检索整个系统上的所有窗口. 否则, 为 <em>WinTitle</em> 指定<a href="../misc/WinTitle.htm">窗口标题或其他条件</a>, 来标识目标窗口, 和/或为 <em>WinText</em> 指定目标窗口的单个文本元素的子字符串(由包含的 Window Spy 实用程序显示).</p>
        <p><em>ExcludeTitle</em> 和 <em>ExcludeText</em> 可用于根据标题或文本排除一个或多个窗口. 它们的规范类似于 <em>WinTitle</em> 和 <em>WinText</em>, 除了 <em>ExcludeTitle</em> 不识别除窗口标题之外的任何条件.</p>
        <p>窗口标题和文本是区分大小写的. 默认情况下, 不检测隐藏窗口, 而检测隐藏文本元素, 除非使用 <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a> 和 <a href="DetectHiddenText.htm">DetectHiddenText</a> 进行更改. 默认情况下, 窗口标题的任意位置包含 <em>WinTitle</em> 或 <em>ExcludeTitle</em> 就能形成匹配, 除非使用 <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a> 进行了更改.</p>
    </dd>
</dl>

<h2 id="Return_Value">返回值</h2>
<p>类型: <a href="Array.htm">Array</a></p>
<p>此函数返回所有符合指定条件的现有窗口的唯一 ID 号的数组. 每个数字是一个<a href="../misc/WinTitle.htm#ahk_id">窗口句柄(HWND)</a>. 如果没有匹配窗口, 则返回空数组.</p>
<p>例如, 如果将返回值赋值给变量 <code>HWNDs</code>, 并且发现了两个匹配的窗口, 则 <code>HWNDs[1]</code> 包含第一个窗口的 ID, <code>HWNDs[2]</code> 包含第二个窗口的 ID, 而 <code>HWNDs.<a href="../lib/Array.htm#Length">Length</a></code> 返回数字 2.</p>
<p>Windows 将按从顶部到底部的顺序检索(根据它们在桌面上的堆叠方式).</p>

<h2 id="Remarks">备注</h2>
<p>鼠标光标下的窗口的 ID 可以使用 <a href="MouseGetPos.htm">MouseGetPos</a> 来获取.</p>

<h2 id="Related">相关</h2>
<p><a href="WinGetCount.htm">WinGetCount</a>, <a href="Win.htm">窗口函数</a>, <a href="Control.htm">控件函数</a></p>

<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a class="ex_number" href="#ExBasic"></a> 访问整个系统中的所有窗口并显示它们的信息.</p>
<pre>ids := WinGetList(,, "Program Manager")
for this_id in ids
{
    WinActivate this_id
    this_class := WinGetClass(this_id)
    this_title := WinGetTitle(this_id)
    Result := MsgBox(
    (
        "Visiting All Windows
        " A_Index " of " ids.Length "
        ahk_id " this_id "
        ahk_class " this_class "
        " this_title "

        Continue?"
    ),, 4)
    if (Result = "No")
        break
}</pre>
</div>

</body>
</html>